STMicro Nucleo-F401re: implemented comprehensive ThreadX RTOS monitor and primitives showcase#45
Merged
fdesbiens merged 14 commits intoJul 20, 2026
Conversation
new file: STMicroelectronics/NUCLEO_F401RE/README.md new file: STMicroelectronics/NUCLEO_F401RE/app/CMakeLists.txt new file: STMicroelectronics/NUCLEO_F401RE/app/common/board_init.c new file: STMicroelectronics/NUCLEO_F401RE/app/common/board_init.h new file: STMicroelectronics/NUCLEO_F401RE/app/common/console.c new file: STMicroelectronics/NUCLEO_F401RE/app/common/sntp_client.c new file: STMicroelectronics/NUCLEO_F401RE/app/common/startup/NUCLEO_F401RE.ld new file: STMicroelectronics/NUCLEO_F401RE/app/common/startup/startup_stm32f401xe.s new file: STMicroelectronics/NUCLEO_F401RE/app/common/startup/tx_initialize_low_level.S new file: STMicroelectronics/NUCLEO_F401RE/app/common/stm32cubef4/stm32f4xx_hal_msp.c new file: STMicroelectronics/NUCLEO_F401RE/app/starter/cloud_config.h new file: STMicroelectronics/NUCLEO_F401RE/app/starter/main.c new file: STMicroelectronics/NUCLEO_F401RE/cmake/FindCMSIS.cmake new file: STMicroelectronics/NUCLEO_F401RE/cmake/FindSTM32HAL.cmake new file: STMicroelectronics/NUCLEO_F401RE/cmake/arm-gcc-cortex-m4.cmake new file: STMicroelectronics/NUCLEO_F401RE/cmake/arm-gcc-cortex-toolchain.cmake new file: STMicroelectronics/NUCLEO_F401RE/cmake/utilities.cmake new file: STMicroelectronics/NUCLEO_F401RE/lib/CMakeLists.txt new file: STMicroelectronics/NUCLEO_F401RE/lib/nucleo_bsp/CMakeLists.txt new file: STMicroelectronics/NUCLEO_F401RE/lib/nucleo_bsp/nucleo_bsp.c new file: STMicroelectronics/NUCLEO_F401RE/lib/nucleo_bsp/nucleo_bsp.h new file: STMicroelectronics/NUCLEO_F401RE/lib/stm32cubef4/CMakeLists.txt new file: STMicroelectronics/NUCLEO_F401RE/lib/stm32cubef4/config/stm32f4xx_hal_conf.h
…t board specs and ThreadX requirements
Booted ThreadX on NUCLEO-F401RE Validated scheduler operation Validated UART console output Validated LED thread Validated flashing and hardware execution
…UCLEO-F401RE (continued)
…and event flags. Modified demo README file to reflect changes.
…aphore functionality and 1 hz applicaion timer.
Co-authored-by: Codex <codex@openai.com>
Retained the PR implementation for overlapping NUCLEO-F401RE files.\n\nCo-authored-by: Codex <codex@openai.com>
fdesbiens
changed the title
Contributor
|
I merged to dev; this will ship with the Q3 2026 release in September. Thank you for this contribution, @AmmarOkla12772. In the future, make sure your original files contain the full mandatory header as shown below. /*
* Copyright (c) 2026 Eclipse ThreadX contributors
*
* This program and the accompanying materials are made available
* under the terms of the MIT license which is available at
* https://opensource.org/license/mit.
*
* SPDX-License-Identifier: MIT
*/Also, there were some minor merge conflicts. Always make sure you pull from upstream before creating a PR. Don't worry, I forget this from time to time myself... |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note: This PR supersedes the previous submission having addressed the review feedback. The AZ3166 refactoring has been undone, and the required MIT license header has been added to main.c.
Overview
This PR extends the validation demo for the STMicroelectronics NUCLEO-F401RE board under
STMicroelectronics/NUCLEO_F401RE/.The goal is to provide a comprehensive ThreadX RTOS demonstration showcasing dynamic memory management, runtime diagnostics, thread monitoring, and synchronization primitives using public ThreadX APIs.
Changes
TX_BYTE_POOLTX_BLOCK_POOLfor fixed-size deterministic memory allocationTX_QUEUETX_MUTEXsynchronization with two competing worker threads sharing a simulated SPI resourceTX_EVENT_FLAGS_GROUPsynchronization between the LED heartbeat thread and an event-processing threadTX_SEMAPHOREsynchronization with a dedicated consumer thread awakened by LED activityTX_TIMERperiodic callback executing once per second from the ThreadX system timer threadtx_thread_info_get()0xEFEFEFEF)Validation
Tested on physical NUCLEO-F401RE board:
79028bytes during operation, indicating no byte pool or block pool leaksToolchain
Notes
All runtime diagnostics are implemented using documented ThreadX public APIs. No private kernel structures or undocumented internal ThreadX data are accessed, maintaining portability across ThreadX targets.